home *** CD-ROM | disk | FTP | other *** search
/ Aminet 22 / Aminet 22 (1997)(GTI - Schatztruhe)[!][Dec 1997].iso / Aminet / util / cli / WhereAre.lha / ReadMe next >
Text File  |  1997-10-05  |  6KB  |  150 lines
  1. Short:        Searches for all copies of drawer/file
  2. Uploader:    dmckinstry@ewu.edu (David McKinstry)
  3. Author:        dmckinstry@ewu.edu (David McKinstry)
  4. Type:          util/cli
  5.  
  6. WhereAre is yet another search utility. The one I
  7. had been using was 'whereis' (I don't know its source
  8. now, but its length was 4968 bytes).  As with most,
  9. it must be started from the cli.  The major difference
  10. (for me) is that it displays all the copies of the file
  11. or drawer (not just files as most) specified in the
  12. command line.  Upon starting, a window opens on the
  13. active screen (presumably Workbench, although Workbench
  14. need not be loaded).  You may click on the check boxes
  15. and buttons displayed to make your selections.
  16.  
  17. For a more thorough description of features and
  18. instructions, study the 'ReadMe' file included in
  19. WhereAre.lha.
  20.  
  21.  
  22. This program is a freeware utility and may be released
  23. without restriction.  Of course, as such the author
  24. accepts no responsibility for its use or misuse.  It
  25. works well for me and my purposes.  If you have any
  26. questions, suggestions, or bug reports, I can be reached
  27. as dmckinstry@ewu.edu.
  28.  
  29. I'm sorry about the unorganized nature of this readme
  30. file, but I've written it up in a hurry, just putting
  31. down additional points as I remember to do so.
  32.  
  33. If you wish to use this, place it in a directory for
  34. which the path has been added.  I put it in my Bin:
  35. directory.
  36.  
  37. Although I have developed it with version 40.62 of the
  38. Kickstart and 40.42 of the Workbench, I haven't used any
  39. libraries (for example, gadtools or utility) that are
  40. specific to these versions.  It would probably work with
  41. version 2.04 of AmigaDOS, but I currently have no way of
  42. testing that.  I can guarantee it won't work on an A1000
  43. running version 1.2 of AmigaDOS.  It seems to fail at
  44. calling LockDosList.
  45.  
  46. WhereAre is yet another search utility. The one I
  47. had been using was 'whereis' (I don't know its source
  48. now, but its length was 4968 bytes).  As with most,
  49. it must be started from the cli with the name of the file
  50. or drawer sought as a command line argument.  The major
  51. difference (for me) is that it locates all of copies of
  52. the file or drawer (not just files as most) specified in
  53. the command line.  Upon starting, a window opens on the
  54. active screen (presumably) Workbench, although Workbench
  55. need not be loaded.  You may click on the check boxes
  56. and buttons displayed to make your selections.
  57.  
  58. All mounted volumes, and a list of options are displayed.
  59. Up to 26 volumes can be displayed if you have a 640 x 480
  60. screen open, but only 8 if your screen is only 640 x 200.
  61. Of course, if you have a graphics card that permits
  62. running a larger workbench a great many more volume names
  63. can be displayed.
  64.  
  65. If your active screen is too small to display all the
  66. mounted volumes, a 'More' button will be included.  Don't
  67. click on 'More' until you've already checked all the
  68. volumes and options you want, as no 'BackUp' is included on
  69. later pages of the display.  Just place a check (they can
  70. be toggled off or on) on the volume(s) you want searched.
  71.  
  72. Options include case sensitivity, inclusion of files
  73. and/or drawers, wild card, and searching only the
  74. partition from which WhereAre is run.  The latter option
  75. ignores any checked volumes and disables the ability to view
  76. remaining volumes on the list.
  77.  
  78. Once you have checked all the options and volumes you wish,
  79. click on the 'Done' button.  If you change your mind and
  80. don't wish to search for anything, be sure no volumes are
  81. checked (also be certain 'Only this Volume' is also
  82. unchecked) before clicking on 'Done'.  As soon as Done is
  83. clicked, the window named 'WhereAre' will disappear and
  84. a smaller window called 'Scanning' will appear.  This
  85. window is there to display a new asterisk every time a
  86. new directory is encountered.  The asterisks will be cleared
  87. at the completion of each line.  This display is to assure
  88. you that something is happening, even if no sought files are
  89. encountered on the volume in question.  Even then, if you
  90. get to a directory that has a large number of large files,
  91. it may be awhile before activity is observed.
  92.  
  93. Note that WhereAre starts at the root level of each volume
  94. and proceeds until all levels have been searched.  If you
  95. wish to abort at any time, just click the close gadget on
  96. the Scanning window.  That will terminate the program.
  97.  
  98.  
  99. The wild card option lets you show all files and/or
  100. drawers on the volume(s) specified that have the entered
  101. string as part of their name. For example, if you enter
  102.  
  103. WhereAre etp
  104.  
  105. having left 'Case Sensitivity' unchecked, checked 'Wild Card"
  106. and checked the volume corresponding to your sys: partition
  107. (e.g. System3.1:), you would likely get an output similar
  108. to the following.
  109.  
  110. File   dated  92-Mar-06 12:39:12   System2.1:c/SetPatch
  111.  
  112. You would also get any other files/drawers with etp included
  113. as a part of their name.  Of course, if you had instead used
  114. 'WhereAre SetPatch', you would have found the same file.
  115. Don't included the typical wild card identifiers (e.g. * or #?).
  116.  
  117. As you can see, the output format shows whether the located
  118. item is a file or drawer, shows the date of and time of the
  119. file/drawer creation and gives the complete path to the item
  120. located.  As the output is to the CLI, it can be redirected
  121. to a disk or ram file for your later examination.  That also
  122. makes it easier if the path is wider that your current CLI.
  123. The program uses a buffer of 512 bytes for the path of the
  124. filename.
  125.  
  126. Note that the only error message produced is when you fail
  127. to give a file or drawer name after the program name.  If
  128. you try to include any switches after the file name, they
  129. are ignored.  All other input is in the window titled
  130. 'WhereAre'.
  131.  
  132. The search is recursive, without a limit on the depth.
  133. However, you could get a failure, and perhaps a crash if your
  134. depth is too deep for the size of your stack.  For example,
  135. with a 4096 stack on my CLI window, the program fails.  It
  136. normally doesn't fail with 8192 as a stack.  However, I've
  137. never had to search beyond 13 levels.  In general, if you
  138. get a failure, try increasing your stack size before giving up.
  139.  
  140. Keep in mind that a thorough source of a large volume takes
  141. quite awhile.  It takes about 2 minutes to do a complete
  142. search of one of my partitions that is 780 megs and has
  143. 608 megs in use.  This is on an A3000 with a 50 MHz '060.
  144.  
  145. I hope you find this useful.  I intend to use is to clean
  146. up some of the redundancy on my 5 plus gigs of hard disk
  147. space.
  148.  
  149. Dave McKinstry
  150.